home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_misc / tg_300.zip / INSTALL.DOC < prev    next >
Text File  |  1996-06-18  |  12KB  |  259 lines
  1.  
  2.                   Telegard Bulletin Board Software, v3.00
  3.                          Installation Documentation
  4.  
  5.                    Copyright (C) 1995,1996 by Tim Strike
  6.                             All Rights Reserved.
  7.  
  8.  
  9.        INTRODUCTION
  10.        
  11.        Welcome to Telegard Bulletin Board Software, version 3.00.  This 
  12.        documentation contains quick instructions for installing Telegard 
  13.        for the first time, or for completing an upgrade from previous 
  14.        versions of the Telegard software.
  15.        
  16.        Please read README.DOC before continuing with this installation.
  17.  
  18.        Please read these instructions very carefully.  The steps we have 
  19.        outlined are designed to ensure that you install our system with
  20.        minimal effort and with success the FIRST time!
  21.  
  22.        If you are upgrading from a previous version of Telegard, you should 
  23.        refer to the section titled "UPGRADE INSTRUCTIONS", otherwise if you 
  24.        are a first time user of Telegard, please follow the "NEW 
  25.        INSTALLATION" section.
  26.        
  27.         
  28.        SYSTEM REQUIREMENTS
  29.  
  30.        Memory                        440K minimum
  31.        Diskspace, installation       2 megs
  32.                   post-installation  1 meg + messages + files + doors + data
  33.                   recommended        10+ megs at least
  34.        Fossil Driver (level 5)
  35.        Share/OS-equivalent (for multinode)
  36.  
  37.  
  38.        PKZIP VERSION NOTES
  39.  
  40.        Our package is released with PKZIP version 2.04g.  This is the 
  41.        latest publically available version of PKZIP as of Jan 5, 1996.
  42.  
  43.        There are several hacked versions of PKZIP 1.10 going around which
  44.        have versions in the 3.nn and 4.nn series of numbers.  PKZIP 1.10
  45.        and subsequently these hacked versions, are *not* compatible with
  46.        the encryption method used in 2.04g and in the file INSTALL.TG.
  47.  
  48.  
  49.        NEW INSTALLATION
  50.  
  51.        1)  Create a new directory for your Telegard BBS
  52.  
  53.        2)  Copy INSTALL.TG into the new directory
  54.  
  55.        3)  Type "PKUNZIP INSTALL.TG -sONLYRAINS" at the DOS command prompt, 
  56.            without the quotes.  This will extract the necessary install
  57.            files for your system.
  58.  
  59.        4)  Type "TELEGARD" at the DOS command prompt, without the quotes.  
  60.            This will start the installation process.  We will ask you a few 
  61.            simple questions regarding the placement of the remaining data 
  62.            files.  You should configure these directories in such a manner 
  63.            that the directory structure is not obvious (i.e. do not use 
  64.            /DATA/ as your data directory).
  65.  
  66.        5)  The installation process will build the desired directory 
  67.            structure, unpack the enclosed data files, and create any other
  68.            data files which are needed for BBS installation.
  69.  
  70.        6)  Run "INDEX BUILD ALL" from the main /bbs/ directory to create
  71.            the index files as required by the system.
  72.  
  73.        7)  From your main bbs directory run "MAKELANG .\LANGUAGE\ENGLISH"
  74.            to compile your new language file (Note: Replace \LANGUAGE\ with
  75.            your correct language path).                                  
  76.  
  77.        8)  Run "TELEGARD -?" to familiarize yourself with the commands 
  78.            available from the command line.
  79.  
  80.        9)  Run "TELEGARD -L" to load the BBS locally -- Hit "ESC" for the
  81.            menu commands available -- Use the System Configuration and
  82.            System Manager commands to setup the remainder of your BBS
  83.            system (remember to change the information in the first user
  84.            record to your OWN personal information!).
  85.  
  86.        10) You may delete INSTALL.TG and *.TWS after the installation has 
  87.            been completed.  These files are only temporary installation 
  88.            files and are not used in the general operation of the BBS.  You 
  89.            should save a copy of the original archive (TG_nnn@n.ZIP) in 
  90.            case you want or need to reinstall the software at a later date.
  91.  
  92.            You can also delete the UPGRADE.EXE file, which is only used if
  93.            upgrading from a previous gamma of Telegard.
  94.  
  95.        11) Remember to read RELEASE.DOC at some point in the near future.
  96.  
  97.  
  98.        UPGRADING INSTRUCTIONS
  99.  
  100.        If you are upgrading from Telegard 2.7, please refer to the section
  101.        immediately following this text.  If you are upgrading from a 
  102.        gamma release of Telegard 3.0, please skip to the section for gamma
  103.        upgrades.
  104.  
  105.        
  106.        TELEGARD 2.7 UPGRADING INSTRUCTIONS
  107.        
  108.        The differences between Telegard 2.7 and Telegard 3.0 are quite 
  109.        profound.  We suggest that you take the upgrade slowly and tackle
  110.        it over a couple of days to ensure that you get the upgrade right
  111.        before putting your new 3.0 system online.
  112.        
  113.        To successfully upgrade from 2.7 to 3.0, you will need the archive 
  114.        "TG_UPG32.ZIP", distributed at the same time that Telegard 3.0 was 
  115.        distributed.  This file contains the upgrade program which is needed 
  116.        to upgrade from Telegard 2.7.
  117.        
  118.        Create a backup of your 2.7 BBS system.  This will ensure you have
  119.        a downgrade path if necessary.
  120.        
  121.        Telegard 3.0 should be placed in a new directory -- your old BBS
  122.        directory will no longer be used.  This will mean that many of your
  123.        system files will have to point towards new directories, etc.  This
  124.        is good for two reasons; firstly, it will ensure that you use 
  125.        software which is only compatible with Telegard 3.0, and secondly; 
  126.        it will ensure that your system security is preserved.
  127.        
  128.        1)  Create a new directory for your Telegard BBS
  129.  
  130.        2)  Copy INSTALL.TG into the new directory
  131.  
  132.        3)  Type "PKUNZIP INSTALL.TG -sONLYRAINS" at the DOS command prompt, 
  133.            without the quotes.  This will extract the necessary install
  134.            files for your system.
  135.  
  136.        4)  Type "TELEGARD" at the DOS command prompt, without the quotes.  
  137.            This will start the installation process.  We will ask you a few 
  138.            simple questions regarding the placement of the remaining data 
  139.            files.  You should configure these directories in such a manner 
  140.            that the directory structure is not obvious (i.e. do not use 
  141.            /DATA/ as your data directory).
  142.  
  143.        5)  The installation process will build the desired directory 
  144.            structure, unpack the enclosed data files, and create any other
  145.            data files which are needed for BBS installation.
  146.  
  147.        6)  Follow the remaining instructions as provided by the 
  148.            installation process, except skip "INDEX ALL BUILD" for now.
  149.         
  150.        7)  You may delete INSTALL.TG and *.TWS after the installation has 
  151.            been completed.  These files are only temporary installation 
  152.            files and are not used in the general operation of the BBS.  You 
  153.            should save a copy of the original archive (TG_nnn@n.ZIP) in 
  154.            case you want or need to reinstall the software at a later date.       
  155.        
  156.        8)  Copy the "TG_UPG32.ZIP" file into your new directory.
  157.        
  158.        9)  Type "PKUNZIP TG_UPG32.ZIP" at the DOS command prompt,
  159.            without the quotes.  This will extract the necessary upgrade
  160.            files for your system.
  161.            
  162.        10) Review UPGRADE.DOC to familiarize yourself with the upgrade
  163.            instructions.
  164.        
  165.        11) Type "UPGRADE" at the DOS command prompt, without the quotes.
  166.            When prompted, input your Telegard 2.7 information and then
  167.            follow the remaining instructions for the upgrade.
  168.  
  169.        12) Switch to your /data/ directory and type "REN CONFRENC.DAT
  170.            GROUPS.DAT".
  171.         
  172.        13) Type "UPDATE" at the DOS command prompt, without the quotes.
  173.            When prompted, select Telegard 2.7 as your upgrade path, and
  174.            the program will do the remainder of the updates from G1 to
  175.            G4 (if using a version of TG_UPD later than 3.2, this step
  176.            may not be neccessary).
  177.            
  178.        14) Type "INDEX BUILD ALL" at the DOS command prompt, to complete
  179.            the update of your index files.  Do this -- whether you've run
  180.            the index build before or not, do it again!
  181.  
  182.        15) Remember to read RELEASE.DOC at some point in the near future.
  183.  
  184.            
  185.        TELEGARD 3.0 GAMMA UPGRADING INSTRUCTIONS
  186.  
  187.        1)  Copy INSTALL.TG into your BBS directory
  188.  
  189.        2)  Type "PKUNZIP INSTALL.TG -sONLYRAINS" at the DOS command prompt, 
  190.            without the quotes.  This will extract the necessary install
  191.            files for your system.  You should replace TELEGARD.EXE,
  192.            TELEGARD.OVR and UNPACK.EXE as well as replace *.TWS files.
  193.  
  194.        3)  You should then run UNPACK for each of the .TWS files in order
  195.            to update the data files that are in use on the system.  To do
  196.            this type "UNPACK <filename> <location>" at the DOS command 
  197.            prompt, without the quotes, replacing <filename> with the .TWS
  198.            filename and <location> with the directory for the unpacking.
  199.            
  200.            Say NO to extract new/non-existant files.  You want to replace
  201.            some files which already exist; saying NO will ensure that you
  202.            can do that.
  203.  
  204.                FILENAME        LOCATION                  OVERWRITE?
  205.                notes.tws       /notes/ directory            yes
  206.                defaults.tws    data directory               yes*  
  207.                language.tws    languages directory          yes**
  208.                utility.tws     main bbs directory           yes
  209.                text.tws        default text directory
  210.                menus.tws       default menus directory
  211.         
  212.            *  overwrite TELEGARD.* files, MENUS.DAT and HARDWARE.DAT files.
  213.            ** overwrite ENGLISH.TXT if you desire (this will wipe out any 
  214.               changes that you did to your language file)
  215.               
  216.        4)  ONLY IF UPGRADING DIRECTLY FROM GAMMA-1 TO GAMMA-3:
  217.  
  218.              (i)  Switch to your /data/ directory and execute "COPY 
  219.                   CONFRENC.DAT GROUPS.DAT" (this will copy your conference 
  220.                   file to the new filename; the old one is kept just for 
  221.                   backwards compatibility until utilities which use it can 
  222.                   be completely updated).
  223.  
  224.              (ii) From your main bbs directory run "INDEX QWK RENUMBER" 
  225.                   (this fixes problems caused by the previous INDEX 
  226.                   release).
  227.  
  228.        5)  Run "INDEX BUILD ALL" to update your files to repair any damage 
  229.            inadvertently caused by the previous INDEX releases and to 
  230.            ensure your indexes are totally up-to-date.
  231.  
  232.        6)  ONLY IF UPGRADING DIRECTLY FROM GAMMA-1 OR GAMMA-2:
  233.  
  234.              (i)  Copy your CONFIG.TG file to a backup (CONFIG.BAK) and 
  235.                   copy your /data/NETWORK.DAT file to a backup (NETWORK.BAK)
  236.  
  237.        7)  Run UPDATE.EXE from the main BBS directory.  Select the version
  238.            from which you are upgrading, and the let the utility update 
  239.            your data files.
  240.  
  241.        8)  Review WHATSNEW.300 for changes done since the previous gamma.
  242.            There will be several instructions in this file on things which
  243.            need to be updated (i.e. language strings which are new, no
  244.            longer used or changed, etc.).  If you replaced ENGLISH.TXT
  245.            with the new one, you do not need to update your languages
  246.            (except if you have other languages defined).  Remember to
  247.            update all your languages!
  248.        
  249.        9)  From your main bbs directory run "MAKELANG .\LANGUAGE\ENGLISH"
  250.            to compile your new language file (Note: Replace \LANGUAGE\ with
  251.            your correct language path).  Repeat as neccessary for each of
  252.            your remaining languages.
  253.  
  254.        10) You may delete INSTALL.TG and *.TWS after the upgrade has 
  255.            been completed, and UPDATE.EXE after it has been run (step 7).
  256.  
  257.        11) Remember to read RELEASE.DOC at some point in the near future.
  258.  
  259.